W08-1. Service 와 Gateway API - 강의 노트

8주차 강의 노트: Service 와 Gateway API (외부 노출)

이번 주 목표

  1. Pod 앞에 Service 가 왜 필요한지, 어떻게 Pod 를 찾는지(selector) 설명할 수 있다.
  2. Service 타입 ClusterIP / NodePort / LoadBalancer 의 차이를 안다.
  3. 클러스터 안에서 서비스 이름(DNS) 으로 통신하는 법을 안다.
  4. Ingress-NGINX 지원 종료(2026년 3월) 와 그 후속 표준 Gateway API 를 이해하고, 도메인 주소로 앱을 공개할 수 있다.

진행: 이론 15분 (이 노트) → 실습 45분 (실습 가이드)

지난주 복습

  • Deployment 가 Pod 3개를 유지, 롤링 업데이트로 v1 → v2
  • Pod 는 다시 만들어질 때마다 이름과 IP 가 바뀐다
  • port-forward 는 Pod 하나에만 연결하는 테스트용 통로


1. 왜 Service 인가

Pod 의 IP 로 직접 접속하면 이런 문제가 생깁니다.

문제 설명
IP 가 바뀐다 Pod 가 죽고 새로 생기면, 롤링 업데이트를 하면 IP 가 바뀝니다
여러 개다 Pod 가 3개면 어느 IP 로 보내야 하나?
늘었다 줄었다 한다 스케일링할 때마다 목록이 바뀝니다

Service 는 Pod 묶음 앞에 세우는 고정된 대표 주소 + 로드밸런서입니다.

flowchart LR
    C["다른 Pod
(예: 웹 → API)"] -- "http://guestbook" --> S["Service: guestbook
ClusterIP 10.96.134.220 (고정)
selector: app=guestbook"] S --> P1["Pod 10.244.0.32
app=guestbook"] S --> P2["Pod 10.244.0.33
app=guestbook"] S --> P3["Pod 10.244.0.34
app=guestbook"]
7주차와 같은 원리

Deployment(ReplicaSet)도, Service 도 라벨로 Pod 를 찾습니다. 그래서 7주차에 라벨을 바꾼 Pod 는 Service 에서도 빠집니다. 문제 Pod 를 서비스에서 떼어 내는 요령이 바로 이것입니다.


2. 포트 세 가지

apiVersion: v1
kind: Service
metadata:
  name: guestbook
spec:
  type: ClusterIP
  selector:
    app: guestbook          # 이 라벨이 붙은 Pod 로 보냄
  ports:
    - port: 80              # Service 가 받는 포트
      targetPort: 8000      # Pod(컨테이너)가 실제로 듣는 포트
flowchart LR
    A["요청
guestbook:80"] -- "port: 80" --> S["Service"] S -- "targetPort: 8000" --> P["Pod (gunicorn 8000)"] N["노드 IP:30080"] -. "nodePort: 30080
(NodePort 타입일 때)" .-> S
이름 누구의 포트? 우리 예시
port Service 가 받는 포트 80 (그래서 http://guestbook 만 써도 됨)
targetPort Pod 의 컨테이너가 듣는 포트 8000 (Dockerfile 의 gunicorn 포트)
nodePort 모든 노드에 열리는 포트 (NodePort 타입) 30080 (범위 30000~32767)

3주차 docker run -p 8080:8000 의 "바깥 포트 : 안쪽 포트" 와 같은 개념입니다.


3. Service 타입

타입은 포함 관계입니다. 위의 타입은 아래 타입의 기능을 모두 가집니다.

flowchart TB
    subgraph LB["LoadBalancer: 클라우드 로드밸런서(외부 IP)까지"]
        subgraph NP["NodePort: 모든 노드의 30000~32767 포트까지"]
            CIP["ClusterIP: 클러스터 안에서만 (기본값)"]
        end
    end
타입 누가 접속할 수 있나 실무에서
ClusterIP (기본값) 클러스터 안의 Pod 만 DB, 내부 API 등 대부분의 Service
NodePort 노드 IP:포트로 바깥에서도 테스트, 직접 구축한 클러스터의 외부 LB 연결용
LoadBalancer 클라우드가 만든 외부 로드밸런서 주소로 관리형 K8s(EKS, AKS, GKE, NKS …)에서 외부 공개

Docker Desktop(kind)에서는 이렇게 동작합니다 (실제 확인)

타입 노트북에서 접속 비고
ClusterIP ❌ (클러스터 안에서만) 정상 동작
NodePort ❌ localhost:30080 으로는 안 됨 노드가 컨테이너라서 노트북에 포트가 열리지 않음. 클러스터 안에서 노드 IP:30080 으로는 됨
LoadBalancer ✅ localhost:포트 로 됨 EXTERNAL-IP(172.x.x.x)가 붙지만 그 주소로는 안 되고, Docker Desktop 이 localhost 로 연결해 줌
예전 자료와 다를 수 있습니다

예전 Docker Desktop(kubeadm 방식) 자료에는 "NodePort 를 localhost:30080 으로 접속" 이라고 나옵니다. 우리가 쓰는 kind 방식에서는 되지 않습니다.


4. 클러스터 안의 DNS: 서비스 이름이 곧 주소

클러스터 안의 DNS(CoreDNS, 6주차 kube-system 에서 본 것)가 Service 이름을 IP 로 바꿔 줍니다.

부르는 방법 언제
guestbook 같은 Namespace 안에서
guestbook.default 다른 Namespace 에서 (이름.네임스페이스)
guestbook.default.svc.cluster.local 전체 이름 (FQDN)

5주차 Compose 의 "서비스 이름 = 주소" 가 클러스터 전체로 넓어진 것입니다. 9주차에 방명록이 postgres 라는 Service 이름으로 DB 에 접속합니다.


5. 외부 공개의 표준: Ingress 에서 Gateway API 로

LoadBalancer 를 앱마다 만들면 앱마다 외부 IP 와 로드밸런서 비용이 생깁니다. 그래서 보통은 입구 하나를 두고, 도메인 이름이나 경로를 보고 안쪽 Service 로 나눠 보냅니다(L7 라우팅).

flowchart LR
    U["사용자"] --> G["입구 하나
(Gateway)"] G -- "guestbook.localhost" --> S1["Service: guestbook"] G -- "hello.localhost" --> S2["Service: hello"] G -- "그 외" --> X["404"]

5-1. Ingress 와 Ingress-NGINX 의 은퇴

5-2. Gateway API: 역할을 나눈 새 표준

Gateway API 는 Kubernetes 공식 프로젝트가 만든 Ingress 의 후속 표준입니다(우리가 쓰는 버전은 v1.6).

오브젝트 하는 일 주로 누가 관리 비유
GatewayClass 어떤 구현체(제품)를 쓸지 인프라 제공자 건물을 지을 시공사
Gateway 실제 입구: 어떤 포트·프로토콜로 받을지 클러스터 운영자 건물의 정문
HTTPRoute 어떤 도메인·경로를 어느 Service 로 보낼지 앱 개발자 정문 안내 데스크의 안내표
Ingress 보다 좋아진 점

  • 역할이 나뉘어 있어서 팀별로 권한을 나누기 좋습니다(운영팀은 Gateway, 개발팀은 HTTPRoute).
  • 가중치 기반 트래픽 분배(카나리 배포, 10주차), 헤더 조건 등이 표준 기능으로 들어 있습니다. Ingress 는 제품별 애너테이션에 의존했습니다.

5-3. 구현체: 우리는 Envoy Gateway

Gateway API 는 규격이고, 실제로 트래픽을 처리하는 구현체를 설치해야 합니다.

구현체 비고
Envoy Gateway ← 우리가 쓸 것 Envoy 프록시 기반, CNCF 프로젝트, 설치 파일 하나로 설치 (v1.9)
NGINX Gateway Fabric NGINX 기반
Traefik, Istio, Cilium, Kong 등 각자 Gateway API 지원
클라우드 구현체 AWS Load Balancer Controller, GKE Gateway 등 → 클라우드 로드밸런서와 연동

HTTPRoute 같은 우리가 쓰는 YAML 은 구현체가 달라도 같습니다. 표준의 장점입니다.

5-4. *.localhost 주소

실습에서는 guestbook.localhost, hello.localhost 를 씁니다. .localhost 로 끝나는 이름은 내 컴퓨터(127.0.0.1) 를 가리키도록 약속되어 있어서, 도메인을 사지 않고도 도메인 라우팅을 연습할 수 있습니다.

브라우저와 curl 은 되지만 다른 프로그램은 안 될 수 있습니다

실제로 확인해 보니 Chrome·Edge·curl 은 *.localhost 를 알아서 처리했지만, Windows PowerShell 의 Invoke-WebRequest 는 The remote name could not be resolved 로 실패했습니다. 실습은 브라우저 또는 curl(Windows 는 curl.exe) 로 합니다.


핵심 요약

8주차 핵심
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
① Service      Pod 묶음 앞의 고정 주소 + 로드밸런서 (selector 의 라벨로 Pod 를 찾음)
② 포트         port(Service) → targetPort(Pod) / nodePort(노드, 30000~32767)
③ 타입         ClusterIP(안에서만, 기본) ⊂ NodePort(노드 포트) ⊂ LoadBalancer(외부 LB)
               Docker Desktop kind: LoadBalancer → localhost:포트 로 접속
④ DNS          같은 NS: guestbook / 전체: guestbook.default.svc.cluster.local
⑤ 외부 공개     Ingress-NGINX 는 2026년 3월 지원 종료 → Gateway API 가 후속 표준
⑥ Gateway API  GatewayClass(시공사) → Gateway(정문) → HTTPRoute(안내표: 도메인·경로 → Service)
               구현체: Envoy Gateway (YAML 은 구현체가 달라도 같음)

참고 자료

더 깊이 보고 싶다면 (볼트 내 정리 노트):

공식 문서:


네비게이션

이전 목록 다음
◀ 7주차 실습 목록으로 8주차 실습 ▶